home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-4543 / psycho_s / psychos.txt < prev    next >
Text File  |  1989-12-31  |  16KB  |  374 lines
  1.                              PSYCHO-SCRIPT
  2.                              ¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.                     A Picture Modulator and Slideshow
  4.                         Program for the Atari ST
  5.  
  6.              Copyright 1994 - MEGASTAR SYNTHESISER COLLECTIVE
  7.                               Version 1.3
  8.  
  9.    Program written and compiled in GFA Basic Version 3.5 by GARETH JONES
  10.  
  11. This is a Public Domain program and you are free to copy and distribute
  12. this program freely, provided that:-
  13.       i) All the files included are retained, and not altered in any way.
  14.      ii) The program is not sold for profit.
  15.  
  16. In the PSYCHO_S folder you should find the following files-
  17.  
  18.        PSYCHOS.PRG - The main program.
  19.        PSYCHOS.TXT - This document.
  20.        COLSWAP.PRG - Picture converter.
  21.           DEMO.MOV - 6 Demonstration Files.
  22.           DEMO.SCP
  23.       COLORSPC.PSY
  24.        INTALOC.PSY
  25.          SWIRL.PSY
  26.          TUBES.PSY
  27.  
  28.      To run this program you will need an Atari ST working in med. resolution
  29. colour mode.
  30.  
  31.  
  32. ABOUT THE PSYCHO PROGRAMS
  33. *************************
  34.      A few months ago a coincidence struck me. There are 16 colours used in
  35. the ST's low resolution mode and 16 channels used by MIDI. It seemed natural
  36. to combine them in some way, and the PSYCHO was the result.
  37.      PSYCHO allowed the user to colour-modulate low resolution pictures
  38. on the ST by means of MIDI commands. This allowed the MIDI musician with a
  39. hardware sequencer, workstation, or drum-machine to "play" real-time graphics
  40. to accompany the music.
  41.      The program was able to load any standard NEOCHROME or low-res DEGAS
  42. pictures, so many different art packages, fractal generators, CAD's etc.
  43. could be used as source material. PSYCHO saved these pictures together with
  44. the appropriate settings in a special .PSY and .MOV files for future use.
  45.      PSYCHO-SCRIPT is a response to several friends requests to do non-MIDI
  46. version of the PSYCHO program. In this version the program is controlled by
  47. an internal clock as apposed to MIDI control. As a result the 11 rotational
  48. Modulation modes are now available to generate a stand-alone slideshow.
  49.  
  50.  
  51.  
  52. ABOUT THE PROGRAM
  53. *****************
  54.      PSYCHO-SCRIPT allows the user to colour-modulate low resolution colour
  55. pictures and to sequence these effects into a dynamic psychadelic slideshow
  56. which can be controlled by an internal clock.
  57.      The program is able to load Neochrome and low-res Degas colour pictures
  58. and is able to save pictures and various parameters as a PSYCHO (.PSY) file.
  59. These pictures can then have their colour palattes modulated by one of the
  60. 16 modulation MODES. These can rotate the colours, switch them on and off, in
  61. set patterns.
  62.      PSYCHO-SCRIPT runs from a programmable Script which controls the
  63. selection of pictures and effects. The Script consists of 300 SCRIPT LINES
  64. each of which allow the selection of a loaded picture, a colour palatte, and
  65. the relative depth and speed of the modulation effects. SCRIPT LINES are
  66. selected and displayed in blocks of ten known as a SCRIPT PAGE.
  67.      SCRIPT LINES can be viewed individualy ( in Manual Mode ) by using the
  68. keys on the keyboard. Or viewed in sequence using the two Script Modes. The
  69. speed of the sequence being controlled by the internal clock, the display time
  70. of each SCRIPT LINE is set by the "Steps" parameter.
  71.      Once the SCRIPT LINES have been programmed all the PSYCHO and Script
  72. parameters are saved as a SCRIPT file (.SCP) and all the picture data is saved
  73. as a MOVIE file (.MOV). These can be loaded back into program for immediate
  74. playback.
  75.  
  76.  
  77.  
  78. MODULATION MODES
  79. ****************
  80. The 16 modulation modes in this program are :-
  81.  
  82.  No.3 ( MCLK ) MIDI CLOCK.
  83.       In this mode the colours of the displayed picture are cycled by
  84.       the presence of MIDI CLOCK messages.
  85.  
  86.  No.1 ( CHAN ) CHANNEL.( NOT AVAILABLE IN PSYCHO-SCRIPT )
  87.       The colours are switched on and off by MIDI NOTE ON and OFF messages
  88.       i.e. MIDI channel 2 switches colour 2 etc. If limiters are set to
  89.       different values, then the colours between limiters will be rotated by
  90.       MIDI clocks.
  91.  
  92.  No.2 ( NOTE ) MIDI NOTE. ( NOT AVAILABLE IN PSYCHO-SCRIPT )
  93.       Here the colours are controlled by 16 notes ( c2 to D#3 ) of a
  94.       single MIDI channel set by the user. If limiters are set to different
  95.       values, then the colours between limiters will be rotated.
  96.  
  97.  No.4 ( VELC ) : VELOCITY CHANNEL. ( NOT AVAILABLE IN PSYCHO-SCRIPT )
  98.       As in CHAN, but the displayed colour depends on the initial
  99.       velocity of the note. If limiters are set to different values, then the
  100.       colours between limiters will be rotated by MIDI clocks.
  101.  
  102.  No.5 ( VELN ) : VELOCITY NOTE. ( NOT AVAILABLE IN PSYCHO-SCRIPT )
  103.       As in NOTE, but the final displayed colour is selected by note
  104.       velocity.If limiters are set to different values then the colours
  105.       between the limiters will be rotated by MIDI clocks.
  106.  
  107.  No.6 ( ANIM ) ANIMATION.
  108.       Displays pictures 1 to 4 in sequence at a rate set by the Cycle
  109.       Colour parameter.
  110.  
  111.  No.7 ( NPIC ) NOTE PICTURE. ( NOT AVAILABLE IN PSYCHO-SCRIPT )
  112.       Allows the the selection of any of the four pictures using notes
  113.       C2, C#2, D2, and D#2 on MIDI channel set by "MIDI EDIT".
  114.  
  115.  No.8 ( POLR ) POLARISATION.
  116.       Sweeps the colours through all possible values.
  117.  
  118.  No.9 ( PSWP ) POSITIVE SWEEP.
  119.       "Blacks outs" all the colours between the limiters, then in
  120.       sequence, displays then one at a time
  121.  
  122.  No.10( NSWP ) NEGATIVE SWEEP.
  123.       "Blacks out" each colour in turn between the two limiters.
  124.  
  125.  No.11( RAND ) RANDOM.
  126.       "Blacks out" all colours between limiters and then displays a
  127.       single randomly selected colour.
  128.  
  129.  No.12( RNDC ) RANDOM COLOUR.
  130.       As with RAND but the final colour screen is a random selection
  131.       of those available in the palatte.
  132.  
  133.  No.13( STRB ) STROBE.
  134.       Alternates picture with blank screen to get strobe effect.
  135.  
  136.  No.14( BSTR ) BACKGROUND STROBE.
  137.       Alternates the background colour between black and white.
  138.  
  139.  No.15( BILD ) BUILD.
  140.       "Blacks out" all colours between the limiters, then puts them
  141.       back one by one.
  142.  
  143.  No.16( DCAY ) DECAY.
  144.       "Blacks out" one by one, all the colours between the limiters.
  145.  
  146.  
  147.  
  148. PSYCHO-MOVIE
  149. ************
  150.      Since originally writing this program I have developed a more powerful
  151. version called PSYCHO-MOVIE. Features include:-
  152.  
  153.      - Increased picture capacity, 64 ( 4meg Hard disk ), 32 ( 2meg hard
  154.        disk ), 40 ( 4meg floppy disk ), 16 ( 1meg ), 8 pictures ( 1/2 meg )
  155.      - 30+ modulation modes, including multiple animations, fades, rotate
  156.        palattes.
  157.      - 300 SCRIPT LINES.
  158.      - Run SCRIPTs either independantly or under MIDI control.
  159.      - 128 SCRIPT LINES directly selectable by MIDI Program Changes.
  160.      - 26 SCRIPT LINES directly selectable from the keyboard.
  161.  
  162. PSYCHO-MOVIE is available for the sum of £5.00  made payable to Mr. G.W.Jones
  163. at the address given at the end of the document.
  164.  
  165.      Should you require a futher demonstration of the awesome power of PSYCHO-
  166. MOVIE then get a copy of the PSYCHO-FRACTAL demo disk which should be
  167. available from the same P.D. library that stocks this program. Also availble
  168. is the MIDI version of PSYCHO called PSYCHO-MIDI. If you have any
  169. trouble getting either of these two programs then they are available from me
  170. for £1.50 each including postage and packing.
  171.  
  172.  
  173.  
  174. GUIDE TO SCRIPT FUNCTIONS
  175. *************************
  176.  
  177. ***** PAGE SELECT ( 1, 11, 21 ) *****
  178.     This button ( Top left hand button on the Script display ) controls which
  179. of the three SCRIPT PAGES are displayed.
  180.  
  181. ***** SCRIPT LINE SELECT ( 1 - 30 ) *****
  182.     Clicking on this column ( on the far left side of the Script display )
  183. hihlights the selected SCRIPT LINE. This automatically changes when "PAGE
  184. SELECT" is altered.
  185.  
  186. ***** PICTURE SELECT ( 1 to 4, blank ) *****
  187.     Using the left and right mouse buttons the operator is able to select from
  188. the Picture Loction the required picture.
  189.  
  190. ***** PALATTE ( 1 to 4 ) *****
  191.     This allows the choice of any of the four palattes that have been loaded
  192. together with the picture data. Alternatively you can use the "VEIW" method
  193. - see VIEW in the Guide to Buttons.
  194.  
  195. ***** MODE ( 1 to 16 ) *****
  196.     Controls the selection of Modulation Modes to be applied to picture and
  197. palatte.
  198.  
  199. ***** LIMITERS ( 1 to 16 ) *****
  200.     These controls the range of most of the Modulation effects. The numbers
  201. correspond directly to the colours in the palatte. With some of the Modulation
  202. modes ( eg. MCLK ) if the first limiter value is higher than the second the
  203. direction of the effect may be reversed.
  204.  
  205. ***** STEPS ( 1 - 999 ) *****
  206.     When running the Script either from STEP or START, this parameter controls
  207. the number of  clocks that each SCRIPT LINE is displayed before moving on
  208. to the next SCRIPT LINE.
  209.  
  210.  
  211.  
  212. GUIDE TO BUTTONS
  213. ****************
  214.  
  215. ***** VIEW *****
  216.      Clicking on this button will display the picture and palatte of the
  217. currently selected SCRIPT LINE. To see the effect of using another loaded
  218. palatte on the picture, left or right-click on the palatte-bar. To return
  219. to the main screen, move mouse off the palatte-bar and click mouse.
  220.  
  221. ***** MANUAL*****
  222.     This allows to view picture and effects, also you can select any other
  223. SCRIPT LINE on the SCRIPT PAGE by using ST keys "1" to "0" .Clicking the mouse
  224. will return you to the main screen.
  225.  
  226. ***** SCRIPT STEP *****
  227.     Runs the script from the currently selected SCRIPT LINE.
  228.  
  229. ***** SCRIPT START *****
  230.     This runs the script from the first SCRIPT LINE.
  231.  
  232. ***** CLEAR PICTURE *****
  233.     Will clear the picture displayed in the currently selected SCRIPT LINE.
  234. Also it will remove the picture and palatte from the corresponding Picture
  235. Location.
  236.  
  237. ***** TEMPO *****
  238.     Sets the rate of the internal clock.
  239.  
  240. ***** EXIT *****
  241.     Returns you to the desktop.
  242.  
  243.  
  244. ***** INSERT *****
  245.     Will insert blank SCRIPT LINES into the script. When the button is pressed
  246. a dialogue box will appear. Using the left and right buttons of your mouse set
  247. "Start Loc" and "End Loc" to the required values, and then click the "OK"
  248. button. Then the SCRIPT LINES at "Start Loc" and "End Loc" and all lines
  249. between will be filled with the standard settings. SCRIPT LINES higher than
  250. "End loc" will be shifted up the appropriate number of lines.
  251.  
  252.  
  253. ***** DELETE *****
  254.     Will delete unwanted SCRIPT LINES from the script. When the button is
  255. pressed a dialogue box will appear. Using the left and right buttons of your
  256. mouse to set "Start Loc" and "End Loc" to the required values. Click the "OK"
  257. button. The SCRIPT LINES between and including "Start Loc" and "End Loc" will
  258. be removed. SCRIPT LINES higher than "End Loc" will be shifted down the
  259. appropriate number of lines.
  260.  
  261.  
  262. ***** LOAD PICTURE *****
  263.     PSYCHO is able to load three low resolution colour picture formats,
  264. Neochrome, Degas, and its own PSYCHO ( .PSY ) format. The latter allows the
  265. additional storing of the modulation mode, MIDI channel, MIDI note transpose,
  266. and the colour limiters.
  267.     Once the button has been pressed a dialogue box will appear showing the
  268. four Picture Locations and the names of the pictures currently stored. Select
  269. which Location you wish to load your picture into, and click "OK". A second
  270. dialogue box appears, from which you select the desired picture format. Then
  271. select the appropriate file from the File Selector.
  272.  
  273.  
  274. ***** SAVE PICTURE *****
  275.     PSYCHO is able to save the data shown in the currently displayed SCRIPT
  276. LINE ( picture, palatte, Modulation mode, and the colour limiters, plus MIDI
  277. Channel and MIDI Note Transpose ) as a PSYCHO file, .PSY. Just click the SAVE
  278. Picture button, and enter file name in the File Selector.
  279.  
  280.  
  281. ***** SAVE MOVIE *****
  282.     PSYCHO is able to save all the loaded pictures and script data as a MOVIE
  283. ( .MOV ) and SCRIPT ( .SCP ) file. Click on the SAVE Movie file button, and
  284. enter the required name in the File Selector. The program will save all the
  285. pictures in the Picture Store one by one until it reaches a empty Picture
  286. Location. Therefore it is important that NO empty picture locations are left
  287. between pictures. If you do, the pictures after the empty store will not
  288. be saved. All the pictures are saved as one large file then the Script data
  289. is saved automatically with the same filename but with the .SCP extention.
  290.  
  291.  
  292. ***** LOAD MOVIE *****
  293.     This enable the user to load a complete set of pictures and and Script
  294. data that was previously saved as MOVIE and SCRIPT files. Click the LOAD MOVIE
  295. button and pick the required MOVIE file from the file selector. The program
  296. will load the pictures into consecutive Picture Location. Once this is done
  297. PSYCHO will search for the corresponding SCRIPT file. If found this will be
  298. loaded into the program. If no file is found the script remains unaltered
  299. ( including picture names ).
  300.  
  301.  
  302.  
  303. USING THE MOUSE
  304. ***************
  305. All parameters can be altered using either the left or right mouse
  306. buttons. To change a value just position the pointer over the corresponding
  307. button and use the left button to raise ,the right to lower. With switches,
  308. the left button is ON, the right, OFF. This makes PSYCHO a very easy program
  309. to operate.
  310.  
  311.  
  312.  
  313. GETTING STARTED
  314. ***************
  315.      Double-click on the PSYCHOS.PRG icon.
  316.      Once the program has loaded the main screen will displayed. Now load the
  317. demo MOVIE file by clicking the "MOVIE LOAD" button and selecting "DEMO.MOV"
  318. from the File Selector. Once the file has been loaded the SCRIPT PAGE will be
  319. updated. The program will also be automatically set to the internal clock.
  320. Now click the "SCRIPT START" button. The program should display a selection
  321. of pictures modulated by various effects at a tempo set by the TEMPO
  322. value.
  323.     After the MOVIE has finished, you can view each SCRIPT LINE by clicking
  324. the appropiate SCRIPT LINE SELECT column and clicking the "MANUAL" button.
  325. You can in "MANUAL" mode switch between SCRIPT LINES manually using the "1" to
  326. "0" keys on the ST's keyboard to select the corresponding SCRIPT LINE on each
  327. SCRIPT PAGE. To return to the Main Screen, just click the mouse.
  328.     You can now experiment with setting different pictures, palattes, and
  329. effects and viewing the results using the "MANUAL" button.
  330.  
  331.  
  332.  
  333. SWAPPING PALATTES
  334. *****************
  335.     You may find that when you rotate the colours of some pictures the
  336. effect is not linear, and the colours become jumbled. This because some art
  337. packages have their colours in logical order, colour1, colour2, colour3,etc.
  338. Whereas other packages ( including PSYCHO, NEOCHROME, KOZMIC ) use the colours
  339. in the hardware order, colour1 colour16 colour2, etc.
  340.     To overcome these difficulties I have included a picture converter
  341. program that will automatically convert the colours from logical order to
  342. hardware order. Just load in a Neochrome or low-res Degas picture into the
  343. program, the order of the palatte colours will be swapped immediately, then
  344. pixel by pixel, the picture data will be converted to match.
  345.  
  346. NOTE! - The COLSWAP program must be run in LOW RESOLUTION.
  347.  
  348.  
  349.  
  350. CLOSING
  351. *******
  352.      If you have any queries or comments about this program please don't
  353. hesitate to write to me at the address below. Any donations, suggestions,
  354. etc. would be gratefully accepted.
  355.      30 May 1994
  356.      Copyright Megastar Synthesiser Collective.
  357.  
  358.      Write to -
  359.      Mr. G.W. Jones .
  360.      36 Tarn Drive ,
  361.      Creekmoor ,
  362.      Poole ,
  363.      Dorset ,
  364.      BH17 7DQ ,
  365.      Great Britain .
  366.  
  367. DISCLAIMER - Mr. G.W.Jones and the MEGASTAR SYNTHESISER COLLECTIVE take
  368. absolutely no reponsibilty for any resultant damage to hardware, software,
  369. data, bank balance, or state of mind of anyone running one of their programs.
  370. "NOTHING TO DO WITH US GUV!.
  371.  
  372. BYE  BYE  !
  373. The Megastar Synthesiser Collective - " Make Music Not War! "
  374.